home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / misc / e-n / hsc / src_docs / features / spctags.hsc < prev    next >
Text File  |  1995-10-07  |  2KB  |  76 lines
  1. <$INCLUDE FILE="inc/macro.hsc">
  2. <WEBPAGE chapter="hsc - Features - " title="Special Tags">
  3.  
  4. <B>hsc</B> adds some special tags, which can be quite useful for maintainers
  5. of big HTML-projects. If you use them right, the can save a lot of time
  6. and nerves.
  7.  
  8. <H2>Comments</H2>
  9.     You can insert a comments with
  10.  
  11.     <BLOCKQUOTE>
  12.     <TG>* This is a hsc-comment *</TG>
  13.     </BLOCKQUOTE>
  14.  
  15.     You can also nest such comments.<P>
  16.  
  17.     And you can comment out sections of html-source without any problems
  18.     for the browser. This simply is possible because comments in the
  19.     hsc-inputfile are not included into the html-output file.<P>
  20.  
  21.     Of course, if you need the standard comments, you can use
  22.     <BLOCKQUOTE>
  23.     <TG>!-- This is a html/sgml-comment --</TG>
  24.     </BLOCKQUOTE>
  25.     as usual.<P>
  26.  
  27. <H2>Include files</H2>
  28.  
  29.     A sourcefile can be included to the text using
  30.  
  31.     <BLOCKQUOTE>
  32.     <TG>$INCLUDE FILE="filename"</TG>
  33.     </BLOCKQUOTE>
  34.  
  35. <H2>Insert several stuff</H2>
  36.  
  37.     You can insert several stuff using the tag
  38.  
  39.     <BLOCKQUOTE>
  40.     <TG>$INSERT what [options]</TG>
  41.     </BLOCKQUOTE>
  42.  
  43.     <H3>Insert current date and time</H3>
  44.         You can insert the current date and time simply by
  45.           <UBQ><TG>$INSERT TIME</TG></UBQ>
  46.         using a default format.<P>
  47.  
  48.          Optionally, you can pass a
  49.         format-string, that discribes the time (see ANSI-C function
  50.         <CODE>strftime()</CODE> for discription of placeholders).Example:<BR>
  51.           <UBQ><TG>$INSERT TIME FORMAT="%b %d  %y"</TG></UBQ>
  52.         inserts current date with the strange ANSI-C <CODE>__TIME__</CODE>-format.
  53.  
  54.     <H3>Insert text</H3>
  55.         As an required argument, you must give a string
  56.         that contains the text. Example:
  57.         <UBQ><TG>$INSERT TEXT="hugo was here!"</TG></UBQ>
  58.         inserts the text "<CODE>hugo was here</CODE>". Of course, this does not
  59.         make much sense.<TG>$INSERT TEXT="..."</TG> is suggested to be used
  60.         with attribute values. Example:
  61.         <UBQ><TG>$INSERT TEXT=<href></TG></UBQ>
  62.         inserts the value of the macro-attribute <CODE>href</CODE>.
  63.  
  64. <H2>Define Macros</H2>
  65.     I think, this feature needs an <A HREF="features/macros.html">
  66.     own page</A>...
  67.  
  68. <P>
  69.  
  70. <* navigation bar *>
  71. <MAIN>
  72. <PREV href="install.html">
  73. <NEXT href="features/syntax.html">
  74.  
  75. </WEBPAGE>
  76.